aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/1ring test README.txt
blob: 8da6819f350240a73ed56fadc161a355ddb1b936 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
This is a test version of onefangs 1ring thingy.  This is a prerelease
test version, it's not even alpha quality yet.  Things will be broken. 
There are known bugs.  There are bits not written yet.  You get to keep
both parts.  I'm not happy with the speed when running under standard
OpenSim, but it's fine with OpenSim-SC.  It's not documented, except the
few things you'll find in this notecard.

1ring is a combination of things.  AO / collar / couples carry &
interaction / emoter / swimmer / probably something I forgot, but those
are the main ones.

RLV will be needed for the couples carry thing, and the collar.

The default object is worn on the skull as a halo.  It's all full perms
(or should be unless I broke that to), so you can easily resize it to be
a bracelet for your wrist, or a collar for your neck, or just plain turn
the prims into what ever you want.  "1ring to do it all, and in the
loveness bind them." is what the text on the ring says, in Tolkien
Tengwar (Elvish, sorta, go read Lord of the Rings, which inspired this
theme).  Yes, "loveness" is a word, I looked it up.

You can simply click on it and use it via the menus.  Some things in the
menu will be upside down, that means I have not written them yet.  Some
things in the menu will have little circles obscuring the letters, that
means you don't have access to that (likely other people wont have access
to it on YOUR device).  Hopefully it's reasonably self explanatory.

The AO part is a more or less standard ZHAO II compatible AO.  You can
edit the ZHAO II notecard and add the animations from your own AO, or
just drag the ZHAO II card plus animations from your AO.  It currently
has the Linda Kellie "RUGGED AO" loaded, which is a kinda boring male AO. 
While you can turn the built in AO off, it'll be needed for those carry
interactions that include moving.  For example the shoulder rides use a
sitting animation for the one on the shoulders, but uses the various AO
animations for the one carrying them.  So they'll walk, stand, fly, swim,
all like they usually would in an AO, but with the other person sitting
on their shoulders.  The AO also acts as a swimmer, if you are flying and
under water, you'll swim.

The AO might fight with your existing AO, but it's needed for the couples
carry thing.  You can turn it on and off.

The collar part is a fairly standard basic collar.  You can even use the
usual method of bringing up the menu - "/1ormenu" for example (first
letters of your name, and the word menu, in channel 1).  It supports RLV,
but no RLV relay yet.  Leash and follow should handle border crossings
and TPs fine.  There is an included "onefang's leash holder" script that
should go into your favourite leash holder.  As well as the usual "make
the leash connect here" function, it is a helper script for the border
crossing and TP following features.  BTW, it is compatible with ***insert
the standard leash holder names here***.

The couples carry & interaction part is probably the main reason people
will want this.  Among other things it lets one avatar carry another. 
There is no end of problems with how OpenSim and Second Life "work" that
had to be worked around to get this to work at all, mostly coz it is
strictly forbidden to sit on an attachment.  Even the old work around has
been stopped.  I had a few options, the one that seems to work best is to
use a single prim that you both sit on, it's not an actual physics prim,
but I replicate most of the avatar movement system in the script.  So you
can walk around, use UP arrow to fly up, fly under water to start
swimming, use DOWN arrow to stop flying, or to crouch (you can crouch
walk to), or to ground sit.  Walking on prims is a little unreliable ,
especially climbing stairs and ramps.  Both people can move, even at the
same time.  Both people can adjust the position of either.  You can save
the current positions.  The border crossing support is VERY clunky, and
not well tested, still working on that.  I plan to add TP follow support
in the future.  It currently works better if the 1ring wearer is the one
selecting the pose and stuff, this will get fixed.

It tries to be clever about who is in what role, but there's a swap menu
(that I need to actually write code for) to take care of that (or not).

The emoter part is from something I wrote long ago.  During a sub
auction, the subject of emoters came up.  I declared that they are
actually quite trivial to write, and wrote one in five minutes while
every one watched.  Who says programming isn't a spectator sport?  Oh
wait, that was me that said that.  That code is now a part of 1ring.  You
say something in channel 12 or 123 -

/12 something     Script owners first name is used for a "/me something"
emote. /123 someone something     someone: something

1ring has customizable menus, though it is beyond the scope of this
document to describe any of it.  Have a look at the .1AOor2.theme and
.1ring.theme notecards, those are the current menu theme files.  If you
are clever you might be able to work out how they work.  Some of the
commands are similar to MLP menu commands.

https://sledjhamr.org/mantisbt/project_page.php?project_id=12 is the
issue tracker for 1ring. Feel free to create an account if you want to
report an issue or request a feature.  Accounts need to be approved by
me.

I'm sure I should have mentioned other stuff here.

The source code is available at https://sledjhamr.org/cgit/1ring/


The soap bubble image was downloaded from
https://www.pngall.com/soap-bubbles-png/download/26145 From the
collection at https://www.pngall.com/soap-bubbles-png License Info:
Creative Commons 4.0 BY-NC  I think "Rojal"
https://www.pngall.com/author/rojal was the creator, it doesn't really
specify.

Most animations are from  Linda Kelly, some are from OpenCollar.  The
leash textures are from OpenCollar.